type
Post
status
Published
date
May 6, 2026
slug
codex桌面程序或者VS Code之codex插件配置
summary
codex桌面程序或者VS Code之codex插件配置
tags
推荐
工具
开发
建站
category
技术分享
icon
password
一、安装codex 客户端
使用安装程序（有网络条件的自行下载，者从此链接处下载）在线安装
二、账号注册和Codex配置使用基础教程
1、访问 https://sub.zbfe.cf/register 注册账号
任意邮箱即可（真实邮箱或者虚拟邮箱均可，提醒：密码不要与邮箱密码或常用密码重复！！！）
2、兑换（凭兑换码兑换）
3、创建api密钥——注意选订阅！！！
注意：这里选择分组的时候，只能选az2-class-trial（其他无效、不可用，想试试的可以试试），选择后点创建
4、创建api密钥后，点击使用密钥
把上面的“使用密钥”方框那里点开，有config.toml文件和auth.json（密钥文件）两个文件的配置。
其中，config.toml文件推荐可以直接使用下面的模板（本次仅仅提供体验模型DeepSeek-V4-Pro，暂不支持其他模型）：
auth.json（没有的话，要自己右键创建一个txt文本，复制内容进去后，把txt改成json后缀即可）
三、设置PC上的配置，让客户端或者插件生效，以win为例（先把文件扩展名和隐藏文件显示勾选），在文件管理器地址栏中输入 %userprofile%\.codex，直接跳转到目录中：
win11系统：
win10系统：
【无论是win或mac的vscode中的codex插件还是codex客户端，都是同样的本机用户目录中的这个目录，mac的需要设置显示隐藏文件夹，如果没有那两个文件，就创建】。手动查询方法——win系统目录是C:\Users\换成你的电脑名\.codex，参考截图自己找一下
配置完成后，记得彻底退出客户端，重新打开让新配置生效
四、codex客户端模型显示
模型会显示自定义，不要换模型，思考程度可以换
可能遇到的问题
- 提示开启沙箱——点一下set up设置沙箱（强制要求）
- vscode的codex插件，如果遇到提示没有选择文件夹路径，就先选一个项目目录
macos参考这个 Codex 使用教程 - 极速安装指南
五、其他
win系统需要提前安装nodejs
1、安装 Node.js 环境
Codex 需要 Node.js 环境才能运行。建议安装 LTS (长期支持) 版本。
官网下载（推荐）
- 点击"LTS"版本进行下载
- 运行
.msi文件按默认引导安装
命令行安装
Windows 注意事项
- 建议使用 PowerShell 而不是 CMD
- 如果遇到权限问题，尝试以管理员身份运行
- 某些杀毒软件可能会误报，需要添加白名单
验证安装是否成功
安装完成后，打开 PowerShell 或 CMD，输入以下命令：
如果显示版本号，说明安装成功了！
2、安装 Codex
安装 Codex
打开 PowerShell 或 CMD，运行以下命令：
这个命令会从 npm 官方仓库下载并安装最新版本的 Codex。
提示
- 建议使用 PowerShell 而不是 CMD，功能更强大
- 如果遇到权限问题，以管理员身份运行 PowerShell
验证 Codex 安装
安装完成后，输入以下命令检查是否安装成功：
如果显示版本号，恭喜你！Codex 已经成功安装了。
修改
C:/用户/<用户名>/.codex/config.toml 和 C:/用户/<用户名>/.codex/auth.json 文件。如需在 VSCode 中使用 Codex，上述步骤完成后，再在扩展中安装 Codex 插件即可。（上面的步骤不能跳过）
1、安装 Node.js 环境
使用 Homebrew 安装
或者访问 nodejs.org 下载 .pkg 安装包。
验证安装是否成功
安装完成后，打开 Terminal，输入以下命令：
复制
检查 Node.js 版本
node --version
检查 npm 版本
npm --version
如果显示版本号，说明安装成功了！
2
安装 Codex
安装 Codex
打开终端，运行以下命令：
复制
使用 sudo 全局安装
国内镜像（下载慢可用）
在 macOS 上，全局安装通常需要管理员权限（sudo）。
提示
- 如果提示 Enter password，请输入你的 Mac 登录密码（输入时不会显示字符）
- 建议在安装完成后运行验证命令确保路径已生效
验证 Codex 安装
安装完成后，输入以下命令检查是否安装成功：
如果显示版本号，恭喜你！Codex 已经成功安装了。
- 作者:NotionNext
- 链接:https://cbyer.eu.org/article/codex%E6%A1%8C%E9%9D%A2%E7%A8%8B%E5%BA%8F%E6%88%96%E8%80%85VS%20Code%E4%B9%8Bcodex%E6%8F%92%E4%BB%B6%E9%85%8D%E7%BD%AE
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
